home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / internet / wincod27.zip / README.TXT < prev    next >
Text File  |  1996-05-08  |  16KB  |  319 lines
  1.      Wincode: Multi-Purpose Encoder/Decoder for Windows
  2.               (C) _Snappy_ (1993-1996)
  3. ------------------------------------------------------------
  4.              written by George H. Silva
  5.  
  6.  
  7.      ***PLEASE DISTRIBUTE FREELY WITH ALL FILES INTACT***
  8.  
  9. Files:    WINCODE.EXE    the main executable program
  10.           WCENGINE.DLL   dynamic link library of coding functions
  11.           WCEHOOK.DLL    dynamic link library of menu hook functions
  12.           WCEFMEXT.DLL   File Manager Extension dynamic link library
  13.           WCHLPKEY.DLL   Help file option dynamic link library
  14.           WCESOCK.EXE    a companion Winsock e-mail/post daemon
  15.           WCEPADDR.WAB   default Wincode address book
  16.           WINSORT.EXE    a companion file-sort utility
  17.           UNINSTLL.EXE   Wincode package UnInstall program
  18.           ZIPLINK.EXE    executable link to PKZIP/PKUNZIP
  19.           ZIPLINK.PIF    ZIPLINK.EXE program information file
  20.           VSWLINK.EXE    Windows executable link to VSDLINK
  21.           VSDLINK.EXE    executable link to DOS Virus Scan software
  22.           VSDLINK.PIF    VSDLINK.EXE program information file
  23.           VSDLINK.DAT    VSDLINK Virus Scanner exit codes
  24.           MACAPPFC.DAT   MAC Finder information database
  25.           SUM.EXE        a BONUS "sum -r/size" DOS utility
  26.           README.NOW     important info file
  27.           README.TXT     this file
  28.           HELPME.HLP     Wincode basics and information for obtaining
  29.                          the real HELP file (WINCODE.HLP)
  30.           LICENSE.TXT    _Snappy_ "User-Friendly" FREEWARE License
  31.           INSTALL.EXE    the Install/Upgrade program
  32.           INSTALL.HLP    the Installer HELP file
  33.           INSTALL.INF    the Installer information file
  34.           CHECKSUM.REF   checksum reference file
  35.           FILE_ID.DIZ    BBS identification file
  36.  
  37.         ****************************************************
  38.  
  39.         PLEASE SEE THE FOLLOWING FILES FOR MORE INFORMATION:
  40.  
  41.         README.NOW
  42.         HELPME.HLP (formerly HELPME.TXT -> now a Windows HELP file)
  43.         VSDLINK.DAT
  44.         LICENSE.TXT
  45.  
  46.         ****************************************************
  47.  
  48.  
  49. This file contains the following information:
  50.  
  51. I.    About Wincode
  52. II.   Wincode Features (very brief list! - MANY NEW FEATURES :-)
  53. III.  Coming Soon
  54. IV.   Requirements
  55. V.    Installing/Running/UnInstalling Wincode
  56. VI.   Availability
  57. VII.  Note to HELP Registered Users
  58. VIII. Copyrights
  59.  
  60.  
  61. NOTE: There is alot of helpful information in the file HELPME.HLP. You can
  62. now automatically access this file from Wincode by selecting any "Help"
  63. option (this file is now the "default help file" if you are not a registered
  64. user - if you are registered, this file is not needed since it duplicates
  65. portions of the *real* HELP file :-).
  66.  
  67.  
  68.  
  69. I. *** About Wincode ***
  70.  
  71. Wincode is a Windows 3.1x program which converts 8-bit BINARY (EXE, COM,GIF,
  72. etc) files to 7-bit ASCII (Text) files (and vice versa) through a process
  73. known as bit-shifting. Wincode currently supports UU/XX/USR/Base64 (MIME 1.0
  74. conformant), BINHEX, BTOA and BOO encoding/decoding. This BINARY/ASCII
  75. conversion allows you to send and receive binary files via e-mail or any
  76. other ascii-based communications system. It provides a quick and easy way to
  77. distribute programs to people all over the world (it takes a few minutes, on
  78. average, for e-mail to reach across the world). UUcoding is a common practice
  79. on many Internet NewsGroups in which users wish to exchange binary data. Base64
  80. coding is used by MIME (Multipurpose Internet Mail Extensions) conformant
  81. e-mail software as a method for attaching binary data to ascii e-mail. BINHEX
  82. is a popular encoding algorithm used mainly on Apple Macintosh computers. BTOA
  83. is a somewhat different variation of the common BINARY/ASCII conversion process
  84. which supports simple compression, several checksum options and will generally
  85. create encoded files that are smaller than other methods due to its conversion
  86. algorithm (mod 85). BOO is an older (extinct?) algorithm used in cross-platform
  87. file transfers that is provided for compatibility (it requires previous
  88. knowledge of decoded output filesize and may hence be unreliable). All these
  89. methods perform the same overall function (i.e. allow binary data to be safely
  90. transmitted through e-mail) but require different formatting algorithms (e.g.
  91. BINHEX supports Run-Length Encoding, BTOA uses mod 85 coding, etc).
  92.  
  93. Wincode and the associated executables and DLLs (NOT including the HELP file)
  94. are distributed as FREEWARE. However, we want to make a distinction: the
  95. program is FREEWARE, but it is NOT Public Domain. _Snappy_ still retains the
  96. Copyright to the source code and to the use and distribution of the program
  97. (see the file LICENSE.TXT). The HELP file is available for a small fee
  98. ($10.00 US) but is NOT required for Wincode to function correctly. Ordering
  99. the HELP file also entitles you to future updates and e-mail based support. The
  100. $10.00 fee is mainly to offset development costs and the amount of personal
  101. time invested. See below and the file HELPME.HLP for more information on
  102. obtaining support.
  103.  
  104. Wincode is 100% compatible with all standard UUcoders, MIME 1.0 conformant
  105. software, BINHEX 4.0 and BTOA v4.0 and v5.2 coders. The MIME (Base64) support
  106. was developed under the guidelines of RFC 1521 (September 1993) and is subject
  107. to our understanding of the document. The BINHEX support was developed under
  108. the guidelines of RFC 1741 (December 1994) and is subject to our understanding
  109. of the document. The BTOA v4.0 and v5.2 support was developed based on freely
  110. available documents by Paul Rutter, Joe Orost & Stefan Parmark (the creators
  111. of BTOA). We welcome all comments and error corrections. 
  112.  
  113. As part of our goal to support all BINARY/ASCII conversion methods in one
  114. (quality :-) product, Wincode now supports encoding/decoding of *seven*
  115. different formats. We have tried to incorporate as many extra features as
  116. possible to make the en/de-coding process painless. The average user may not
  117. need/use all of Wincode's features, but they *are* Free!
  118.  
  119. NOTE TO DEVELOPERS: WCENGINE.DLL contains ALL of Wincode's 'working' code
  120. (currently) accessed through 80+ functions/procedures. We created this SIMPLE
  121. interface to allow Developers to integrate the Wincode Engine into any
  122. program. We will provide the API and royalty free usage to interested
  123. developers under certain conditions. Please contact the _Snappy_ development
  124. team for more details:
  125.  
  126.    development@snappy.global2000.net
  127.  
  128.  
  129.  
  130. II. *** Wincode Features (very brief list!) ***
  131.  
  132.        - Full featured Windows 3.1 program
  133.        - Easy access ButtonBar for hassle-free operation
  134.        - Drag and Drop support (use for batch en/de-coding -> Wincode also
  135.          allows multi-file selection from File Open dialogs)
  136.        - SMART decoding (handles single files, multi-part files, can
  137.          determine what is encoded or not, etc. -> see the HELP file for
  138.          more information)
  139.        - Fully configurable...We're not joking!
  140.        - EMBL UUcode compatible
  141.        - Supports UU, XX or User defined En/De-coding
  142.        - Supports Base64 (MIME conformant) En/De-coding
  143.        - Supports BINHEX En/De-coding (with option to include MAC finder info
  144.          when encoding to make decoding on a MAC *very* easy!)
  145.        - Supports BTOA v4.0 and v5.2 En/De-coding
  146.        - Supports BOO En/De-coding
  147.        - Supports En/De-coding to/from the Clipboard!
  148.        - Supports automatic CODE TYPE detection (just use Auto Detect).
  149.        - Powerful Scripting language can be used to "program" Wincode
  150.          (includes new automatic "Repair" damaged files option!)
  151.        - Supports automatic ZIP/UNZIP (requires PKWare's ZIP/UNZIP 2.0)
  152.        - Supports automatic Virus Scanning (requires a DOS Virus Scanner -
  153.          see the VSDLINK.DAT file for more information)
  154.        - Application menu hooking option to integrate Wincode's menu
  155.        - Includes INSTALL program for upgrades
  156.        - Includes UNINSTALL program for removal
  157.        - Integrated file-sorting companion program (separate
  158.          executable for easier upgrading) which handles MANY types
  159.          of file header formats
  160.        - Integrated Winsock compatible e-mail/post daemon (separate
  161.          executable for easier upgrading) to allow for automatic e-mailing
  162.          and posting of encoded documents (see Requirements)
  163.        - Multimedia support - see the HELP file for details
  164.        - It's ALL FREE...
  165.  
  166.  
  167.  
  168. III. *** Coming Soon ***
  169.  
  170.        - 32-bit Win95/WinNT version. In progress but no date set yet. Keep
  171.          an eye on our HomePage for early BETAs...
  172.        - User suggestions...?
  173.  
  174.  
  175.  
  176. IV. *** Requirements ***
  177.  
  178.       - IBM compatible running DOS 3.3 or higher
  179.       - 286 or higher processor with at least 2MB memory
  180.       - Windows 3.1/3.11 running in standard or enhanced mode OR Win95
  181.       - About 1.6MB of disk space without HELP file (~2.0MB with HELP file)
  182.         (Sorry about the disk space - this should be reduced in the coming
  183.          months with the release of 32-bit version)
  184.       - ***NOTE*** To use Wincodes built-in E-Mail/Post capabilities, you
  185.         must have a Winsock setup. This means that you are using a Windows
  186.         Socket stack (WINSOCK.DLL) of some sort connected directly to the
  187.         internet (ethernet, SLIP, PPP, TwinSock, TIA, SLiRP, etc). The
  188.         E-Mail/Post Daemon is a Winsock v1.1 compatible app and has been
  189.         tested with Trumpet Winsock, SunSoft PCNFSPro Winsock, and Winsock
  190.         running under Win95. Improper or missing Winsock setup will only
  191.         result in harmless error messages :-)
  192.  
  193.  
  194.  
  195. V. *** Installing/Running/UnInstalling Wincode ***
  196.  
  197. If you have not already done so, expand the ZIP archive into a temporary
  198. directory (or a floppy-disk). Start Windows, select FILE|RUN from Program
  199. Manager or File Manager and type in the full path of the INSTALL.EXE program
  200. (run it). The INSTALL program will copy/expand all the files to a directory
  201. you specify (overwriting older files), upgrade your WINCODE.INI (if you are
  202. running an older version of Wincode) and create a Program Manager Group and/or
  203. icon. See the HELPME.HLP file for basic instructions on using Wincode.
  204.  
  205. ***IMPORTANT NOTES:
  206.    1) ALL files (listed above) must be present in the same directory for
  207.       Installer to function properly. You should INSTALL first, then move
  208.       selected files to directories of your choice (i.e. delete the README.TXT,
  209.       place SUM.EXE in your DOS directory, etc.). The install program uses the
  210.       Windows LZEXPAND.DLL to decompress and copy the required files. If you
  211.       receive any error messages during install, please contact _Snappy_ for
  212.       assistance.
  213.    2) If you receive a Program Manager DDE failure (usually under Windows95),
  214.       try RE-STARTING Windows. We have only observed this error under Win95
  215.       on computers that have been used extensively without restart. If this
  216.       fails, installation WILL proceed but PM Groups will not be created.
  217.  
  218. Wincode can now be un-installed in 2 easy steps. First, run Wincode and
  219. select 'Options|Configuration...' (CTRL-F) from the menu. You will see the
  220. configuration dialog which has an 'UnInstall...' button. Choose this to select
  221. the UnInstall method. The UnInstaller will remove/copy/list all files
  222. included in the Wincode package. However, it does NOT remove itself OR the
  223. directories that Wincode may have used. Therefore, the second step is to
  224. remove these directories and UNINSTLL.EXE from your drive. Wincode should now
  225. be completely erased from your drive.
  226.  
  227.  
  228.  
  229. VI. *** Availability ***
  230.  
  231. Recent versions of Wincode (or other _Snappy_ software) are always
  232. available at the following locations:
  233.  
  234.     - The Internet - the _Snappy_ Software site! All of our software is
  235.       available by three different methods:
  236.  
  237.       1) WWW forms - point your browser at: http://snappy.global2000.net/
  238.          and check out our HomePage! If you can't get through, try our
  239.          MIRROR site at: http://www.global2000.net/users/snappy/snappy/
  240.          (YES, there are two "snappy/" in the address! :-)
  241.  
  242.       2) Anonymous FTP - visit us at: snappy.global2000.net
  243.          MIRROR: www.global2000.net/users/snappy/
  244.  
  245.       3) Automated e-mail - send a request to our server and receive an
  246.          encoded copy by e-mail. Visit our HomePage for more info or send
  247.          a BLANK e-mail to: snappy@snappy.global2000.net for a TEXT copy
  248.          of our HomePage.
  249.  
  250.       In the future, we will try to establish mirror sites for our software.
  251.       Please visit our HomePage for recent developments...
  252.  
  253.     - CompuServe (check the WinShare forum; keyword: Snappy, Wincode, etc.)
  254.  
  255.     - America Online (keyword: Snappy, Wincode, etc.)
  256.  
  257.  
  258.       
  259. VII. *** Note to HELP Registered Users ***
  260.  
  261. If you are a registered user but have not received your HELP file, *please*
  262. contact us at: support@snappy.global2000.net with your registration info
  263. (name, address, e-mail address, etc). Many orders arrived with illegible
  264. and/or missing e-mail addresses. _Snappy_ uses your e-mail address as your
  265. user registration code. Further, some orders were shipped but *not received*.
  266. We can't track mail failures (we don't have the resources :-(  ) so we rely
  267. on customers to please get in touch with us if they have a problem.
  268.  
  269. Please note that registration is a ONE-TIME fee. In other words, your initial
  270. registration keeps you in our database to be eligible for future HELP file
  271. updates! However, it is up to YOU to keep us up to date with your registration
  272. info (e-mail address) and to request the HELP file updates from our server
  273. (this is now a built-in feature of Wincode).
  274.  
  275. If you need phone support, drop us an e-mail and we'll send you a contact
  276. number. This service is ONLY for registered users and calls are INCOMING ONLY.
  277.  
  278.  
  279.  
  280. XIV. *** Copyrights ***
  281.  
  282. Wincode is a TradeMark of _Snappy_ Software.
  283.  
  284. - portions of this program are copyright (C) 1983,1995 Borland
  285. - Windows is a trademark of Microsoft Corporation
  286. - PKZIP/UNZIP are copyright (C) 1989-1993 PKWARE Inc. All Rights Reserved.
  287. - GIF is a service mark of CompuServe Incorporated
  288. - WordPerfect is a registered trademark of Novell, Inc.
  289. - Procomm Plus for Windows is copyright (C) 1992-1993 Datastorm Technologies, Inc.
  290. - Star Trek: The Next Generation is a registered trademark of Paramount
  291.   Pictures
  292. - The Simpsons is trademark and copyright (C) Twentieth Century Fox Film
  293.   Corporation. All Rights Reserved.
  294. - Pinky and the Brain is copyright (C) Amblin Entertainment in association with
  295.   Warner Bros. Animation
  296. - DOOM is copyright (C) 1993 Id Software, Inc.
  297.  
  298. Copyrights or Trademarks referenced in any material accompanying this software but
  299. not mentioned above have been omitted in error. _Snappy_ observes and respects
  300. all copyrights and trademarks.
  301.  
  302.  
  303.  
  304. Have fun!
  305.  
  306. _Snappy_ Software ;-)
  307.  
  308.  
  309. _Snappy_ Info:  snappy@snappy.global2000.net
  310. Wincode Info:   wincode@snappy.global2000.net
  311. Bug Reports:    bugs@snappy.global2000.net
  312. FeedBack:       feedback@snappy.global2000.net
  313. HomePage:       http://snappy.global2000.net/
  314. MIRROR:         http://www.global2000.net/snappy/snappy/
  315.                (YES, there are two "snappy/" in the address! :-)
  316. --------------------------------------------------------------------------
  317.  
  318. [GHS 05/08/96]
  319.